home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / vol_400 / 409_01 / doc / svgakit.doc < prev    next >
Encoding:
Text File  |  1993-10-16  |  2.9 KB  |  66 lines

  1.  
  2.                       The SuperVGA Test Library
  3.                       -------------------------
  4.  
  5. The SuperVGA Test Library is a set of routines for working with SuperVGA
  6. video cards that have a VESA VBE comliant Video BIOS. This library was
  7. an offshoot from the development of the Universal VESA VBE, which is an
  8. installable TSR to provide VESA VBE video BIOS extensions for most
  9. SuperVGA cards. It is intended to show how to program the SuperVGA
  10. cards through the VESA VBE and uses some of the more powerful features
  11. that the latest standard include in your own software. It was not
  12. designed with speed in mind, but more as an explanatory and exploratory
  13. tool.
  14.  
  15. This library supports many of the extended features of today's SuperVGA
  16. adapters, such as being able to separately set the read and write banks
  17. and support for extended page flipping. This is all done via the
  18. standard VESA VBE programming interface.
  19.  
  20. NOTE: All source code is formatted with 4 space tabs, including the
  21.       assembly language source.
  22.  
  23. NOTE: This library has '386 specific code in it, so it will _not_ work
  24.       with machines without a '286 or lower processor. Some of the code
  25.       such as the screen clearing code etc uses fast 32 bit string
  26.       instructions to run at full speed on new VESA VLB Local Bus
  27.       video cards.
  28.  
  29. Using it in your own programs
  30. -----------------------------
  31.  
  32. The SuperVGA test programs all call upon a single C library to access the
  33. SuperVGA using the VESA VBE programming interface. You can use this
  34. same library to provide SuperVGA support in your own applications, or
  35. you can take the source code for the library as a starting point and
  36. expanding on it from there.
  37.  
  38. As the library was not designed with speed in mind, some of the functions
  39. such as line drawing can be sped up significantly by recoding them in
  40. assembly language.
  41.  
  42. Microsoft C compatability
  43. -------------------------
  44.  
  45. I have now included both a Borland linkable version of the library,
  46. and a Microsoft C 6.0 linkable version of the library. Since all of the
  47. assembler code is written in TASM's ideal mode (because I _hate_
  48. MASM mode, and it is too much of a pain to swap over) the assembler
  49. files will need to be assembled with TASM, not MASM. You should not need
  50. to do this however, since you can use the pre-assembled object files
  51. that come in the svga_msc.lib file.
  52.  
  53. Test programs
  54. -------------
  55.  
  56. The library has five test programs, for 16 color, 256 color, 32k color,
  57. 64k color and 16 million color SuperVGA video modes. Simply run the programs
  58. and follow the instructions. The code in these test program should give
  59. you an idea of how to use the SuperVGA routines in your own programs.
  60.  
  61. Note that the test programs require a VESA VBE compliant SuperVGA in
  62. order to run, so if your video card does not have the VESA VBE in the BIOS,
  63. then you will need to install the Universal VESA VBE before running the
  64. test programs.
  65.  
  66.